Markdown, quarto, webpages, pandoc
1/18/23
often useful to produce short documents that mix code snippets, plots, text, images
could use PPT, Keynote, Word (but don’t play nicely with version control)
use a simple text based version
markdown is widely usedsome bread in a dutch oven
\[\chi^2 = \sum_i \Big( \frac{y_i-y(x_i; a_1\dots, a_M )}{\sigma_i} \Big)^2 \]
an online editor at stackedit, to just have a play
placing images where you want them (arbitrarily on page) requires some work
you need to render / transform it (only seconds, but not instantaneous)
if you make mistakes you (it’s a very light version of coding)
if you link to local files (images, etc), you have to remember to move them along (not a problem if everything is online)
markdown (itself) structures your documents
can easily be tranformed into pdf, pptx, docx, revealjs, etc.
gets rendered nicely on github.com, by defauilt
easy to edit, rules are simple to learn
computations code in r, python, julia et al and make them part of your documents \(\rightarrow\) quartoVSCode with markdown plugin (linting, preview)github.com repo which gets rendered using a tool called jekyll under the hood)quartoa command line tool that renders a flavour of markdown called qmd (quarto-markdow)
a superset of markdown, so any previous work should be ok
by adding some additional info at top of document, you can opt into lots of good stuff
YAMLA text block delimited by ---, key/value
quartoif you like RStudio, there is a nice interface
VScode has a plugin that works well
or if you prefer emacs/vim/nano/TextEdit, the command line tool is not that hard to use.
https://quarto.org/
https://rstudio.org/ - now pos.it: https://posit.co/
the original proposal for markdown: https://daringfireball.net/projects/markdown/
literate programming
Matlab / publish()
notebooks, Pluto.jl